home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / list52.lqr / LIST52.DOC < prev   
Text File  |  1985-06-03  |  7KB  |  154 lines
  1.  
  2.                                                                  LIST     Page 1
  3.  Command  LIST
  4.  -------------
  5.  
  6.  Purpose:  To display the contents of an ASCII text file,  line by  line
  7.            with the aid of scrolling and positioning commands.
  8.  
  9.  Format:   LIST  [d:][path]filename[.ext]
  10.  
  11.  Remarks:  An ASCII file of any size may be listed.
  12.  
  13. |          The "filename" is optional.  If omitted, you are prompted  to
  14. |       to enter  a filename.   You may  include drive,  path, and  wild
  15. |       cards in the file name.   The first file which matches  the name
  16. |       is displayed until an end-of-file character is encountered.
  17.  
  18.            LIST was  designed to  display ASCII  files.  That  is, files
  19.         which  contain  text  and  not  binary  or  control codes.  Text
  20.         characters usually range from a value of 32 to 127.
  21.  
  22.            Characters  below  32  (a  blank)  are  replaced with a funny
  23.         character to indicate that a non-displayable character has  been
  24.         encountered.  This character is an upside-down question mark.
  25.  
  26.            Characters above 127 may be valid graphic characters, and may
  27.         be displayed if  the '8' command  is in effect.   To insure that
  28.         characters above ASCII value 127 are not displayed, use the  '7'
  29.         command.
  30.  
  31.            The  file  is  displayed  with  one  logical  record  on each
  32.         80-column display line.   A logical record  ends in a  linefeed.
  33.         The maximum logical record may  be 255 characters long.  If  the
  34.         record exceeds 80  characters, you may  view the portion  beyond
  35.         the 80 columns  by using the  scroll right command,  or by using
  36.         the Wrap feature.
  37.  
  38.            The Wrap  command toggles  ON or  OFF the  wrapping of  lines
  39.         longer than 80 characters.  With Wrap on, lines are displayed in
  40.         their  entirety,  80  characters  per  display line.  The scroll
  41.         -left and -right functions are disabled when Wrap is ON.
  42.  
  43.            The file may  be PRINTed as  it it displayed.   The P command
  44.         toggles  the  printer  on  or  off.   When  first entered, the P
  45.         command causes the current screen  to be printed.  As new  lines
  46.         are displayed, they too are printed.  Printing may be stopped by
  47.         entering another P command.  The PrtSc key may also be used, but
  48.         the title and prompt lines will be printed with the lines of the
  49.         file.
  50.  
  51.  Restrictions
  52.  ------------
  53.  
  54.            All positioning is relative to the current block in  storage.
  55.         The size of the block depends on the amount of memory available,
  56.         and up to 64K-bytes is allocated to the file buffer. The program
  57.         requires at least 4K bytes.
  58.  
  59.         PC-DOS Version 2.0 or later is required.
  60.  
  61.         ANSI.SYS is NOT required.
  62.                                                                  LIST     Page 2
  63.  Key functions and Commands
  64.  --------------------------
  65.  
  66.         On the COMMAND line, enter a letter or control key:
  67.  
  68.         Letter(s)       Control key     Function
  69.         -----------     ------------    ------------------------
  70.                         Enter           continue to next page
  71.         Q, X            ESCape          terminate and exit to DOS
  72.         T               HOME            restart from first block (top)
  73.         B               END             skip to end of file (bottom)
  74. |       D or +          PgDn            scroll down one page
  75. |       U or -          PgUp            scroll up one page
  76.         H or ?          F1              list commands (HELP)
  77.         L               left arrow      scroll left 20 columns
  78.         R               right arrow     scroll right 20 columns
  79.                         up arrow        up one (previous) line
  80.         N               down arrow      down one (next) line
  81.  
  82. |       W                               toggle wrap of lines over 80 chars
  83. |       P                               toggle printer on or off
  84.  
  85. |       K                               toggle keyboard flush
  86.  
  87. |       7                               turn off high bit
  88. |       8                               leave high bit on (default)
  89.  
  90.  
  91.         /text                           find 'text'
  92.         A               F3              find next occurance of 'text'
  93.  
  94.  
  95.                         ctl-HOME        restart from CURRENT block
  96.                         ctl-PgUp        restart from first block (TOP)
  97.                         ctl-PgDn        skip to end of file (BOTTOM)
  98.                         ctl-left-arrow  reset scroll to column 1
  99.  
  100.  
  101.                         F1              Help
  102.                         F3              Find next
  103.                         F10             Exit
  104.                                                                  LIST     Page 3
  105.  
  106.  Scanning for text
  107.  -----------------
  108.  
  109.            To scan for a character string, type a slash (/) followed  by
  110.         one or more (up to 32)  characters.  The scan text, but not  the
  111.         slash,  is  displayed  on  the  command  line.  The scan is case
  112.         sensitive.  That is, lower case scan text will only match  lower
  113.         lower case file text.
  114.  
  115. |          While  the  program  is  searching  for  the text, the bottom
  116. |       display line is changed to say "Scanning".
  117.  
  118.            If the text is found, the line containing it is displayed  as
  119.         a high-intensity line.
  120.  
  121.            If the text is NOT found, the bottom line (25) is changed  to
  122.         say '*** text not found ***', and the display remains unchanged.
  123.  
  124.  Screen attributes
  125.  -----------------
  126.  
  127.            There are three classes  of attributes used.  One  for normal
  128.         display lines  - lines  2 to  24 -  another for  special lines -
  129.         lines 1 and 25, and a third for the background color.
  130.  
  131.         These attributes may be changed by using DEBUG:
  132.  
  133. |        at offset 13C = 09     ;special lines, hi-lighted or lt.blue
  134. |        at offset 13D = 02     ;normal lines, green
  135. |        at offset 13F = 07     ;background, black
  136.  
  137.         If these values don't match, you have a different version.
  138.         ----------------------------------------------------------
  139.  
  140.  
  141.  
  142.         Written by Vernon Buerg for the  IBM PC using DOS 2.0 and  is
  143.         supplied for public domain  use. All rights reserved. Not for
  144.         sale or hire.
  145.  
  146.         Lines beginning with | denote changes to the latest version.
  147.  
  148.         Version 4.1, April 27, 1984.
  149.         Version 4.15, June 2, 1984.
  150.         Version 4.2, July 14, 1984.
  151.         Version 5.0, August 10, 1984.
  152.         Version 5.1, August 27, 1984.
  153. |       Version 5.2, September 29, 1984.
  154.